home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINSYSTM / PROQWK11.ZIP / PROQWK.TXT next >
Text File  |  1994-01-09  |  25KB  |  491 lines
  1. ProQWK.txt
  2.  
  3. (See end of this file for revision history.)
  4.  
  5. LEGAL STUFF:
  6.  
  7. This is the text file that accompanies the ProQWK Utilities,
  8. (c) 1993 by Socratic Software.
  9.  
  10. "ProComm Plus for Windows", "Windows ASPECT" and "Action Bar" are
  11. trademarks (c) 1992 Datastorm Technologies, Inc.
  12.  
  13. "Windows" is a trademark of Microsoft Corporation.
  14.  
  15. The script "ProQWK.wax" was compiled using the Windows ASPECT compiler,
  16. but was NOT written by Datastorm Technologies or any of its employees.
  17.  
  18. Socratic Software is not affiliated with Datastorm Technologies in any
  19. way.
  20.  
  21. DISCLAIMER:
  22.  
  23. Socratic Software does not make any guarantees, implicit or explicit,
  24. regarding the script "ProQWK.wax", and is not responsible for anything
  25. that may occur as a result of using it.  Users of this script are
  26. expected to exercise discretion and accept responsibility for such
  27. use, and any effects arising thereof.  So there.
  28.  
  29. ABOUT ProQWK:
  30.  
  31. What does this script do?
  32.  
  33.     ProQWK is a little utility meant for ProComm Plus for Windows users.
  34. We think it satisfies a need that many PC+/Win users have -- that is, to
  35. rename QWK packets in such a manner that the user can keep many QWK packets
  36. from the same source in their download directory at one time.  The utility
  37. renames QWK packets so that when a download of a new QWK packet takes
  38. place, the file transfer doesn't crash.  As well, ProQWK checks for the
  39. existence of a file with the extension "QWK", and if it doesn't find it,
  40. it won't rename.  Thus, users don't have to try and remember whether they
  41. renamed their QWK files previously.
  42.     When a user chooses to rename a series of QWK files, ProQWK will
  43. delete the highest-numbered file that it is configured to keep for the BBS
  44. in question.  For example, a user may have ProQWK configured to keep seven
  45. extra QWK packets for a BBS called, oh, let's say "redeye" for example.
  46. If the QWK file name for the BBS is "redeye", ProQWK will look for a file
  47. named "redeye.qw6" (because the user chose seven extra packets for that
  48. series, and ProQWK starts numbering QWK files at zero, eg., "redeye.qwO"),
  49. and upon finding it, will delete it.  Next, it will change the name of the
  50. file "redeye.qw5" (if found) to "redeye.qw6"; "redeye.qw4" to "redeye.qw5";
  51. "redeye.qw3" to "redeye.qw4", and so on, until it does the last renaming,
  52. "redeye.qwk" to "redeye.qw0".  If there was no "redeye.qwk" in the down-
  53. load subdirectory, ProQWK will not go through this renaming procedure,
  54. because it would be unnecessary.  Please note that each time ProQWK renames
  55. & cycles "QWK" files (actually "QW?" files) in this manner, one file will
  56. be deleted and each remaining "QW?" file will be bumped up one rung on
  57. the "ladder".
  58.     ProQWK also is designed to help out with another problem sometimes
  59. encountered when using QWK offline readers -- when uploading a reply packet,
  60. a user will sometimes forget whether they have already uploaded it --
  61. ProQWK alleviates this problem by allowing users to upload, and then
  62. delete the "REP" packet in one "motion".  They can also choose to  upload
  63. only, or to delete only, REP packets that they wish to upload or delete.
  64.  
  65. Why bother?
  66.  
  67.     The main reason to use these utilities is to protect your QWK
  68. packets from premature deletion.  Some users may only keep one copy of a
  69. QWK packet for a particular BBS, read it, delete it, and then download
  70. a new one.  ProQWK is not going to be of much use to them.  But if you
  71. want to keep a packet from yesterday, and from a couple of days before
  72. that (etc.), for example, you may find ProQWK useful.  You can always go
  73. a packet or two (or up to ten) back & find those messages that you read
  74. a few days ago.  If you don't keep multiple copies of QWK packets, once
  75. you delete that QWK packet, it's gone, unless you have some kind of deleted
  76. file recovery utility.  We like to think that ProQWK is a more elegant
  77. alternative.
  78.  
  79. But doesn't Zmodem automatically rename files?
  80.  
  81.     In many communications software programs, zmodem downloads are
  82. automatically renamed when a file with the same name is already present in
  83. the download subdirectory.  The standard zmodem protocol, used by ProComm
  84. Plus for Windows, does not perform that function.  ProQWK is meant to at
  85. least enable users to work around this, if they desire to keep multiple
  86. copies of QWK files on their disk.  It doesn't *run* automatically, since
  87. users have to start it, and tell it which files to rename, but it is easier
  88. (and more convenient, if it is assigned to a "Meta Key") than using a file
  89. management utility to madly rename/delete/move files before the new file
  90. begins downloading.
  91.  
  92. How do I use it?
  93.  
  94.     Before downloading a fresh "qwk" packet for a BBS, simply choose
  95. the "QWK" option from the main menu and select the name of the BBS whose
  96. "qwk" packet you are about to download (ProQWK must be first set up to rename
  97. the files for that BBS.  See section below regarding setup.).  ProQWK will
  98. then rename the "QW?" files associated with that BBS, provided the setup
  99. was run properly.  As well, you can delete individual QW? files using
  100. ProQWK, rather than switching to a file management utility.
  101.  
  102. DO NOT ATTEMPT TO RENAME "QWK" PACKETS DURING A DOWNLOAD, OR WHEN A DOWNLOAD
  103. IS IMMINENT!  THIS MAY/WILL RUIN YOUR DOWNLOAD! (You may rename "QWK" files
  104. for BBS "A" while downloading a "QWK" file for BBS "B", but not for "A" while
  105. downloading "A")
  106.  
  107.     We suggest assigning a Meta Key to the "ProQWK.wax" script, in
  108. order to have ProQWK available at the touch of a button.  See your ProComm
  109. Plus for Windows user manual, or online help for more information on
  110. setting up Meta Keys to run scripts.
  111.  
  112. FILES NEEDED:
  113.  
  114. In order to use ProQWK Utilities, you need to have the archive,
  115. "PROQWK11.ZIP", which includes:
  116.  
  117.     ProQWK.txt    this file
  118.     ProQWK.wax    the Windows ASPECT executible file
  119.     socsof1.nil    the icon library for ProQWK Utilities &
  120.                 Socratic software
  121.  
  122. Installation & Setup:
  123.  
  124.     Uncompress the file "PROQWK11.ZIP" using PKZIP or other program
  125. that can uncompress "ZIP" files.
  126.  
  127.     The only files that need to be in any specific subdirectory are
  128. "ProQWK.wax", which should be copied to the subdirectory in which ProComm
  129. Plus for Windows expects to find your Windows ASPECT scripts; and
  130. "socsof1.nil", which should be copied to the subdirectory in which the
  131. executable "PW.EXE" (for ProComm Plus for Windows) is located (for
  132. example "c:\prowin").
  133.  
  134.     Once these two files have been placed in the proper subdirectories,
  135. the script can be run by selecting "Script...Run..." from the ProComm
  136. Plus for Windows pull-down menus, and choosing "ProQWK.wax" from the list
  137. that appears, or by selecting the "Script File" combobox button (the
  138. button with the underlined arrow pointing down) on the ProComm Plus for
  139. Windows "Action Bar", and selecting "ProQWK.wax" from the list that
  140. appears.  If you have not used ProQWK before (or if you have and your
  141. "ProQWK.ini" file has been moved, erased, or renamed), it will ask you if
  142. you wish to go through the setup routine.  If you wish to do so, select
  143. "Setup", and you will be taken directly to the setup routine.  If you
  144. choose "Cancel," the script will stop running and you will either have to
  145. find your "ProQWK.ini" file and place it in your Windows subdirectory, or
  146. run ProQWK again and choose to go through the setup routine.
  147.  
  148.     ProQWK Utilities will create a new file on your hard drive called
  149. "ProQWK.ini" (I know what you're thinking: "Ugh! Not ANOTHER 'ini' file!"
  150. But, it's not that bad! :) See "De-installing ProQWK" below.), which will
  151. be placed in your Windows subdirectory.  This file is necessary for ProQWK
  152. to read various setup information in order to be able to execute.  Whenever
  153. you save changes to your configuration, ProQWK will update the "ProQWK.ini"
  154. file.
  155.  
  156. Setup Options:
  157.  
  158. When you are faced with the ProQWK setup dialog box, you will need
  159. to enter the path to your "download" subdirectory, which is where you
  160. keep your downloaded QWK files, for example "c:\prowin\dnload". If you
  161. don't enter the proper path, ProQWK will not be able to rename/delete
  162. any of your QWK type files, and will be at least 50% u